uxset parm - Pass Parameters

This section describes the command uxset parm (UXSETPARM on OS/400) which enables up to 30 parameters to be passed to the following Uprocs within a session. The parameters positioned by a parent Uproc are available to its children in the standard format: under the numbers 1 to 30 or in the Dollar Universe form in the variables: S_P1 to S_P30.

The passed parameters with this command can be used:

• In the standard form: only in the Uprocs script.
• In the Dollar Universe form: In the Uproc script or in the scripts launched by the batch envelop: pre and post processing routines.

The command syntax is as follows:

uxset parm "parm1" "parm2" ... "parm30"

Description of Items

• parmn

  Designates from 1 to 30 parameters. The number of parameters is limited to 30. Each parameter has a maximum length of 255 characters; the total length of parameters (the sum of the lengths + twice the number of parameters) must not exceed 2074 characters.

Example

In the following session:

If the command uxset parm "10" "Base Full" is executed by Uproc P1, Uproc P2 may use the second parameter via  S_P2, and Uproc P3 may use both parameters via S_P1 and S_P2 etc.

If this distribution is to be interrupted for P2 to transmit further parameters to P4, a new uxset parm command must be executed in P2.

Recover Parameters on OS/400

The parameters are not intrinsically recovered in the classic OS/400 programs. The command UXGETPARM allows the user to recover the parameter value passed from the command UXSETPARM or UXORDRE in a DCL variable.

CALL PGM(UXGETPARM) PARM('PARM=n' 'DCLVAR=var')

This command must be used in the CL. It accepts two parameters:

• PARM: positional parameter number to recover: 0 to 11
• DCLVAR: string of maximum length 256 characters. CL variable the parameter value will be written in.

In qsh, the parameter n can be used directly in the $n shell variable.